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Overview 

Echelon Corporation provides a predefined set of Standard Network Variable Types 
(SNVTs) in order to promote interoperability among LONWORKS™-based products. 
SNVTs facilitate interoperability by providing a well-defined interface for 
communication between nodes made by different manufacturers. A node may be 
installed in a network and logically connected to other nodes via network variables 
as long as the data types match. A list of all available SNVTs and details of their 
definitions is provided in the Master SNVT List. For further explanation of SNVTs 
please refer to the NEURON® C Programmer's Guide. 

The Master SNVT List 

The following list provides information on the definition of all available SNVTs. 
SNVTs are expressed as either fixed point or floating point numbers, enumeration 
lists or structures. 

The representation for all fixed point numeric SNVTs is as follows: 

SNVT Rang e Type Definition 

.. 65535 unsigned long 

-32768 .. 32767 signed long 

.. 255 unsigned short 

-128 .. 127 signed short 

The representation for the floating point SNVTs is ANSI/IEEE 754 floating point: 1 
sign bit, 8 exponent bits, and 23 mantissa bits, for a total of 32 bits. For all the floating 
point SNVTs, the range is approximately -1E38 to +1E38 units. Floating point 
objects may be declared as local variables and as network variables, and can be 
communicated across the network. 

All available SNVTs are listed in the Master SNVT List. This list will be updated 
periodically as new SNVTs are added. SNVTs are made available to the NEURON C 
compiler through the special file snvt.typ. Updates to this file will be made 
available on the Bulletin Board. All units are Systeme Internationale (SI) except 
those shown in italics. 
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Measurement 


Name 


Resolution 


Range 


SNVT# 


Angular velocity 


SNVT_angle_vel 


0.1 radians /sec 


-3,276.8 .. 3,276.7radians/sec 


4 




SNVT_angle_vel_f 


* » * * 


-1E38 .. 1E38 radians/sec 


50 


Character 


SNVT_char_ascii 


N/A 


0..255 


7 


Char string 


SNVT_str_asc 


N/A 


see Structures below 


36 




SNVT_str_int 


N/A 


see Structures below 


37 


Concentration 


SNVT_ppm 


1 ppm 


.. 65,535 ppm 


29 




SNVT_ppm_f 


«-»«-» 


0.. 1E38 ppm 


58 


Count, event 


SNVT_count 


1 count 


.. 65,535 counts 


8 




SNVT_count_f 


» * * * 


-1E38 .. 1E38 counts 


51 


Count, incremental 


SNVT_count_inc 


1 count 


-32,768 .. 32,767 counts 


9 




SNVT_count_inc_f 


* * * * 


-1E38 .. 1E38 counts 


52 


Current 


SNVT_amp 


0.1 ampere 


-3,276.8 .. 3,276.7 amps 


1 




SNVT_amp_f 


* * * * 


-1E38 .. lE38amps 


48 




SNVT_amp_mil 


0.1 milliampere 


-3,276.8 .. 3,276.7 milliamps 


2 


Date 


SNVT_date_cal 


YYYY,MM,DD 


see Structures below 


10 


Day of week 


SNVT_date_day 


Enum List 


see Enum Lists below 


11 


Energy, elec 


SNVT_elec_kwh 


1 KWH 


.. 65,535 kilowatt-hour 


13 




SNVT_elec_whr 


0.1 WHR 


.. 6,553.5 watt-hours 


14 




SNVT_eIec_whrJ 


* * * * 


.. 1E38 watt-hour 


68 


Energy thermal 


SNVT_btuJ 


* * * * 


-1E38 .. 1E38 btu 


67 




SNV7_btu_kilo 


1 kilo-btu 


.. 65535 kilobtu 


5 




SNVT_btu_mega 


1 mega-btu 


.. 65J>35 mega btu 


6 


Flow 


SNVT_flow 


1 liter /sec 


.. 65,535 liters/sec 


15 




SNVTJlowJ 


* * * * 


-1E38 .. 1E38 liters /sec 


53 




SNVT_flow_mil 


1 milliliters/sec 


.. 65,535 milliliters/sec 


16 


Installation source 


SNVT_config_src 


Enum List 


see Enum Lists below 


69 
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The master list, continued... 



Measurement 


Name 


Resolution 


Range 


SNVT# 


Length 


SNVTJength 


0.1m 


.. 6,5535 m 


17 




SNVT_length_f 




-1E38 .. lE38m 


54 




SNVT_length_kilo 


0.1 km 


.. 6,553.5 km 


18 




SNVT_length_micr 


0.1 urn 


.. 6,553.5 urn 


19 




SNVT_length_mil 


0.1 mm 


.. 6,553.5 mm 


20 


Level, continuous 


SNVT_lev_cont 


.5% 


.. 100% 


21 




SNVT_lev_cont_f 


* * * * 


.. 100% 


55 


Level, discrete 


SNVT_lev_disc 


Enum List 


see Enum Lists below 


22 


Mass 


SNVT_mass 


0.1 g 


.. 6,553.5 g 


23 




SNVT_mass_f 


* * * * 


0.. lE38g 


56 




SNVT_mass_kilo 


0.1 kg 


.. 6,553.5kg 


24 




SNVT_mass_mega 


0.1 ton 


.. 6,553.5 metric tons 


25 




SNVT_mass_mil 


0.1 mg 


.. 6,553.5 milligrams 


26 


Phase/rotation 


SNVT_angle 


0.001 radian 


.. 65.535 radians 


3 




SNVT_angle_f 




-1E38 .. 1E38 radians 


49 


Power 


SNVT_power 


0.1 watt 


.. 6,553.5 watts 


27 




SNVT_power_f 


* * * * 


-1E38 .. 1E38 watts 


57 




SNVT_power_kilo 


0.1 kilowatt 


.. 6,553.5 kilowatts 


28 


Pressure - gauge 


SNVT_press 


0.1 kilopascals 


-3,276.8 .. 3,276.7kilopascals 


30 


Pressure - absolute 


SNVT_press_f 




.. 1E38 pascals 


59 


Resistance 


bN v I _res 


U.l Uhms 


u .. o,jjjj unms 


ii 




SNVT_res_f 


»»»» 


-1E38 .. 1E38 Ohms 


60 




SNVT_res_kilo 


0.1 kilo-Ohms 


.. 6,553.5 kilo-Ohms 


32 


Sound level 


SNVT_sound_db 


0.01 dB 


-327.68 .. 327.67 dBspl 


33 




SNVT_sound_db_f 




-1E38 .. 1E38 dBspl 


61 


Speed 


SNVT_speed 


0.1 m/s 


.. 6,553.5 m/s 


34 




SNVT_speed_f 


» » » » 


-1E38 .. 1E38 m/s 


62 
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The master list, continued... 



Measurement 


Name 


Resolution 


Range 


SNVT# 




SNV.T_speed_mil 


0.001 m/s 


.. 65535 m/s 


35 


Temperature 


SNVT_temp 1 


0.1 °C 


-274 .. 6,279.5 °C 


39 




SNVT_temp_f 


* * * * 


-274 .. 1E38 °C 


63 


Time of day 


SNVT_date_time 


HH:MM:SS 


see Structures below 


12 


Time - elapsed 


SNVT_rime_f 


* * * * 


-1E38 .. 1E38 sec 


64 




SNVT_time_passed 


HH:MM:SS:LL 


see Structures below 


40 


Volume 


SNVT_vol 


0.1 liter 


.. 65535 liters 


41 




SNVT_vol_f 


* * * * 


.. 1E38 liters 


65 




SNVT_vol_kilo 


0.1 kiloliter 


.. 6553.5 kiloliters 


42 




SNVT_vol_mil 


0.1 milliliter 


.. 6553.5 milliliters 


43 


Voltage 


SNVT_volt 


0.1 volt 


-3,276.8 .. 3,276.7 volts 


44 




SNVT_volt_dbmv 


0.01 db uv dc 


-327.68 .. 327.67 dB uvolts 


45 




SNVT_volt_f 


* * * * 


-1E38 .. 1E38 volts 


66 




SNVT_volt_kilo 


0.1 kilovolt 


-3,276.8 .. 3,276.7 kilovolts 


46 




SNVT_volt_mil 


0.1 millivolt 


-3,276.8 .. 3,276.7 millivolts 


47 


Phone state 


SNVT_telcom 


Enum List 


see Enum Lists below 


38 



1 SNVT_temp represents tenths of a degree Celsius above -274 °C. To get SNVT_temp units define a 
constant: c_to_K equal to 2740 which is added to temperature expressed in tenths of degrees C 
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SNVT Structures 



The structure definition used by SNVT_date_cal is: 

typedef struct { 

unsigned long year; 

unsigned short month; 

unsigned short day; 
} SNVT_date_cal ; 



The structure definition used by SNVT_date_time is: 
typedef struct { 

unsigned short hour; 
unsigned short minute; 
unsigned short second; 
} SNVT_date_time; 



The structure definition used by SNVT_str_asc is: 
typedef struct { 

unsigned char ascii [31]; /* 0...30 chars + NUL 



terminator */ 



} SNVT_str_asc ; 



The structure definition used by SNVT_str_int is: 

typedef struct { 

unsigned short char_set; 

unsigned long wide_char [15]; /* 0...14 chars + NUL 



term. */ 



} SNVT_str_int ; 



The structure definition used by SNVT_time_passed is: 

typedef struct { 

unsigned short hours; 

unsigned short minutes; 

unsigned short seconds; 

unsigned short milliseconds; 

} SNVT_time_passed; 



Details of the values of the elements of the structures are described in the following 
table. 
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Name 


Units 


17 3TI CTC* 




5NVT_date_cal 


YYYY,MM,DD 








year 
day 


0-3000 
0-1 ? 

U 1 i. 

0-31 


represents null date 

means month not specified 

u udy not specineu 


SNVT_date_time 


HH:MM:SS 








hour 

mimifp 

1 1 111 I u It: 

second 


O-SQ 

\J J7 

0-59 


255 represents null time 


SNVT_str_asc 


ASCII Characters 




30 characters 




R "hit rKarc 

tprminat'nr 

L V_ 1 II III lu IU 1 


iJU LUal 

x'00' 


zero-length string plus terminator 

I cpr trbclili) nun 


SNVT_str_int 


Int'l Char Set 




14 'wide' characters 




char set code 
16 bit chars 
tprmina tor 


0-255 
14 char 

x'0000' 


tbd 

zero-length string plus terminator 

rpnrpcpntc null 


SNVT_time_passed 


HH:MM:SS:LL 








hours 

minutes 

seconds 

10 milliseconds 


0-254 
0-59 
0-59 
0-990 


255 represents null elapsed time 



Enumeration Lists 

All SNVTs that are identified as enumeration lists have enum type definition files 
that can be optionally included. The following declaration must be included in the 
application code to use the SNVT enum type definition files. 

#include "typedef file" 

Details of the enumeration lists are described in the following table. 



£ ECHELON 



6 



The SNVT Master List and Programmer's Guide 



i ii a 111 c 


Enum Definition 


Notes 


SNVT_config_src 




typedef file: 
typedef name: 


SNVT_CFG . H 
=onf ig_source 






CFC.LOCAL 


Node will use self installation functions of 
NEURON C to set its own address table entries 




1 CFG EXTERNAL 


Node's addressing information will be set by 






an outside source 








CFG NUL 


OxFF 






SNVT_date_day 




typedef file: SNVT_DH.H 
typedef name: days_of_week 






DAY_SUN 










1 DAY_MON 










2 DAY.TUE 










3 DAY_WED 










4 DAY_THU 










5 DAY_FRJ 










6 DAY_SAT 










DAY_NUL 


OxFF 






SNVT lev disc 




typedef file: SNVT_LEV.H 
typedef name: discrete_levels 






2-state device 


3-state device 


4-state device 




ST_OFF 


off 


off 


off 




1 ST_LOW 


on 


low 


low 




1 ST MFD 


on 


high 


med 




j) d i ill vj n 


on 


high 


high 




4 QT DM 


on 


high 


high 




ST NUL 


OxFF 






SNVT_telcom 




typedef file: 
typedef name: 


SNVT_TEL . H 
telcom_states 






TEL_NOTINUSE 


"null state (UO)" not in use 






1 TEL_OFFHOOK 


"call initiated (Ul) 








2 TEL_DIALING 


"Overlap Sending (U2)" 






3 TEL_DIALCOMP 


"Outgoing Call Proceeding (U3)" 






4 TEL_RINGBACK 


"Call Delivered (U4)" hearing ringback 
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The enumeration list, continued... 



Name 


Enum Definition 


Notes 




S TEL INCOMING 


Prp^pnf (\ ]f\ Y' inrnminc* rail Viae nnf \/£>r cfartf>rl rincrincr 






ionly on lbUi\ line; 




6 TEL_RINGINCj 


Call Received (U7) incoming call when the user has 






indicated alerting but has not yet answered 




7 l LL_ANbWLKhD 


Connect Request (U8) user has answered the call and is 






waiting to be awarded the call 




9 TEL_TALKING 


Active (U10) two parties are exchanging data 




10 TEL_HANGDMGUP 


"Disconnect Request (Ull)" user has hung up" 




11 TEL_HUNGUPX 


Disconnect Indication (U12) the other side hung up 




12 TEL_HOLD 


Suspend Request (U15) user has requested the network 






suspend the call 




13 TEL_UNHOLD 


//T1 T1 i / T ^\// 1 1 1 11 / 11 1 i 

Resume Request (U17) resume a held call (usually go back 






to TEL_TALKING) 




14 TEL_RELEASE 


Release Request (U19) user has requested the network to 






release 




15 TEL_FULLDUP 


"Overlap Receiving (U25)" user has acknowledged the call 






and is prepared to receive additional information (if any) 






in overlap mode non-ISDN values 




16 TEL BLOCKED 


connection with blocking, (call waiting disabled) 




17 TEL_CWAIT 


call waiting coming in 




18 TEL_DESTBUSY 


destination busy 




19 TEL_NETBUSY 


problem, network 




20 TEL_ERROR 


problem, non-network 




TEL_NUL 


(OxFF) 



Disclaimer 

Echelon Corporation assumes no responsibility for any errors contained herein. 
No part of this document may be reproduced, translated, or transmitted in any form without permission from Echelon. 



e 1991. 1992 Edition Corporation. ECHELON, 
LON, and NEURON ire VS. registered 
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LONMANACER. LONBUILDER, LONTTALK, 
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Echelon Corporation 
4015 Miranda Avenue 
Palo Alto, CA 94304 
Telephone (415) 855-7400 
Fax (415) 856-6153 



Echelon Europe Ltd 
105 Heath Street 
London NW3 6SS 
England 

Telephone (071) 431-1600 
Fax (071 ) 794-0532 
international Telephone • 44 71 
431-1600 

International Fax . 44 71 794-0532 



Echelon Japan KX. 
AlOS Gotanda Building '808 
10-7, Higashi-Gounda 1-chome, 
Shinagawa-ku, Tokyo 141, Japan 
Telephone (03) 3440-8638 
Fax (03) 3440-8639 
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